home *** CD-ROM | disk | FTP | other *** search
Text File | 1990-10-26 | 40.7 KB | 1,035 lines |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- WhereIs Version 4.1a
-
- Released Nov 1, 1990
-
- A PC-DOS / MS-DOS Fast File Finder
-
-
- Written by Keith Ledbetter
- 4240 Ketcham Drive
- Chesterfield, VA 23832
- (804) 674-0780
- (6:00pm - 10:00pm Eastern Time)
-
-
- Electronic mail on GEnie to ORION.MICRO
- CompuServe to 72240,1221
-
-
- Program and Documentation Copyright 1988, 1989, 1990 by Keith Ledbetter.
- All rights reserved.
-
- Portions Copyright Borland, International.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ACKNOWLEDGEMENTS
-
-
- Special thanks to Herb Martin, Hal Hudler, Chris King, David
- Essex, Arnold Kedy, and all of the other BETA testers for their
- invaluable suggestions and debugging help. Also, special thanks
- to the crowd on the Blue Ridge Express BBS system (804-790-1675)
- for constantly prodding me to put in that "one other nice feature"
- they'd like to see!
-
-
-
- WhereIs is distributed as a Shareware program. Simply put, this
- means that you may try out the program for a reasonable amount of
- time, after which you will pay for the program if you find it of
- use to you. Please help support the Shareware concept by paying
- for and registering your copy. Please see the order form on the
- following page. When you register your copy of WhereIs, you will
- receive a "branding" utility that will allow you to brand all
- future versions of WhereIs with your name and serial number. No
- upgrade fees in the future; you only pay once!
-
-
-
-
- WhereIs is written in Turbo C v2.0 by Borland, International.
-
-
-
-
-
-
-
- WhereIs Registration Form Keith Ledbetter
- 4240 Ketcham Drive
- Chesterfield, VA 23832
-
-
- WhereIs Version 4.1a Quantity Price
-
- Disk with branding utility ($15/copy): _______ __________
-
- Total enclosed __________
-
- Please make payment by check or money order (in US funds) payable
- to "Keith Ledbetter".
-
- Please specify the diskette size(s) that are acceptable for you:
-
- ___ 5.25" 1.2MB ___ 3.5" 1.44MB ___ 5.25" 360KB ___ 3.50" 720KB
-
-
- Name ________________________________________________________
-
- Company ________________________________________________________
-
- Address ________________________________________________________
-
- ________________________________________________________
-
- Phone ________________________________________________________
-
-
- Where did you get WhereIs? ____________________________________
-
- Multi-System and Reseller Licenses:
-
- Site, corporate, network, and reseller licenses are available
- for WhereIs. Check the line on the order form or contact me for
- more information. The following schedule provides some
- examples of multi-system license fees. The fee includes one
- master diskette which you may then copy and use on the number
- of machines listed below:
-
- # Users Price
- ------- -------
- 5 $ 70.00 ($14 / copy)
- 10 130.00 ($13 / copy)
- 25 300.00 ($12 / copy)
- 50 550.00 ($11 / copy)
- 100 1,000.00 ($10 / copy)
- Unlimited 1,500.00
-
- WhereIs v4.1a Page 1
-
-
- Introduction
-
-
-
- Note: New features in this version are marked with an '|' beside them.
-
-
- Thank you for taking the time to try out WhereIs v4.1a. You will find
- that WhereIs can satisfy almost all of your file searching needs. It has
- a multitude of search options, some of which are:
-
- o The ability to search inside ARC, ZIP, PKA, PAK,
- ZOO, and LZH archived files.
-
- o True regular expression searching on filenames.
-
- o The ability to display duplicate entries across all of
- your disk drives (even those duplicates that are in the
- archive files mentioned above!).
-
- o Up to 25 filenames can be excluded from the search.
-
- o Built-in ZIP archive error detection. Every time you
- do a search that includes ZIP files, every ZIP file on
- your hard drive is checked for integrity!
-
- o The ability to do restrictive searches on such criteria
- as file dates and file sizes.
-
- o The ability to do a verified (or un-verified) deletion
- of any files found in the search (great for periodically
- deleting those .BAK files or files with a size of zero).
-
- o Support for Novell's "volume" configurations.
-
- o Default switches can be set in an environment variable.
-
-
- Don't be fooled by imitations. There are recent file finder programs out
- there making claims that their "features" are "never before found in any
- file finder programs". Funny! Their "features" (like date-range searching
- and filesize searching) have been in our program a YEAR before they were
- even released!
-
-
- Now, here is the only pitch that you'll see in this document for some of
- your hard-earned money. WhereIs (as of v4.0) is now being distributed as
- a Shareware product. If you find that you are still using this program a
- couple of weeks after you get it, please take the time to fill out the
- registration form at the front of this documentation file and send in your
- registration fee of $15. This program has taken up a lot of my time over
- the last two years (just ask my wife!...well, on second thought, you'd better
- not..), and I feel that I can better support those people who are using
- WhereIs by going this route. And, by the volumes of suggestions that I get
- on the program, there must be quite a few of you out there! As of this
-
- WhereIs v4.1a Page 2
-
-
- Introduction
-
-
- release, there will be (limited) telephone support for WhereIs to those users
- who register their copies of WhereIs. I say limited because, like many other
- Shareware authors, I make my "real" living by programming at a "real" job
- during the day. Registered WhereIs users may call me at (804) 674-0780
- between the hours of 6:00 pm - 10:00 pm (Eastern) Monday-Friday, and from
- 10 am - 6 pm on the weekends. Thank you for supporting WhereIs and my other
- Shareware programs!
-
- WhereIs v4.1a Page 3
-
-
- What WhereIs Does
-
-
-
- WHEREIS helps hard drive owners retain (some of) their sanity by locating
- files on their hard drives. We've all had situations where we KNOW that a
- file is somewhere on the hard drive; we just can't remember where. Another
- added feature of WHEREIS is that it can be told to look inside of ARC files,
- too. This is a very important feature with the common acceptance of archived
- files these days. In this document, "ARC files" is used as a generic term
- for any file with the following extension:
-
- .ARC .ZIP .LZH .ZOO .PAK .PKA
-
- Other advanced features of WHEREIS include (a) grep-type searching on
- filenames (ie: find filenames with a '4' in the fifth character), (b) date
- and time range specifiers, and (c) file size range specifiers. There are
- many switches for WHEREIS, and it is highly recommended that you read this
- document carefully so that you will be able to get the most out of the
- program. There are very few things you can't do with WHEREIS when it comes
- to locating files. As an advanced example:
-
-
- whereis cde:*.bak "[0-9]" -gt1024 -lt2048 -s12-10-89 -b12-20-89 -v
-
-
- How about THAT for a command line? What this would do is delete all .BAK
- files on drives C:, D:, and E: that have a number somewhere in the filename
- (ie: PROG01.BAK). But, only if the file is between 1025 and 2047 bytes in
- length, and was last modified sometime between the dates of 12-10-89 and
- 12-19-89.
-
- Yes, I know that you'll probably never need to do something exotic as
- this, but it shows the power that you have with WHEREIS. Take the time to
- learn WHEREIS, and it will always be your friend (sounds like Mr. Rogers!).
-
- WhereIs v4.1a Page 4
-
-
- The Command Line Interface
-
-
-
- Invoking WHEREIS is simplicity itself. If you do not specify a path,
- then WHEREIS will search the entire default drive. If you specify a
- starting path, then the search will occur from that path downward (only).
-
- Here are some basic command line examples:
-
- whereis ab*.c search entire default drive for any filename
- matching "ab*.c".
-
- whereis \turboc\ab*.c search downward from the \turboc\ directory
- on the default drive looking for "ab*.c".
-
- whereis d:*.dat -a search entire drive d: and all ARC files
- on drive d: looking for "*.dat".
-
- whereis cd:*.dat -a search entire drive c: and drive d: and all
- ARC files looking for "*.dat".
-
- whereis myprog search entire default drive looking for
- "myprog.*" (WHEREIS will append a ".*" to
- a filename with no extender specified).
-
-
- WhereIs v4.1a Page 5
-
-
- Additional Command Line Switches
-
-
-
- Switch: -A
- Meaning: search all ARC files
- Description: The '-a' switch tells WHEREIS to look in any ARC file
- encountered for a matching filename. If a matching filename
- is found, it will be displayed in parenthesis along with the
- full name of the ARC file it resides in.
-
-
- Switch: -AO
- Meaning: search -ONLY- ARC files
- Description: The '-ao' switch tells WHEREIS to ONLY look in any ARC file
- encountered for a matching filename. If a matching filename
- is found, it will be displayed in parenthesis along with the
- full name of the ARC file it resides in.
-
-
- Switch: -ARC -PAK -PKA -LZH -ZIP -ZOO
- Meaning: search only the ARC formats specified
- Description: These switches tell WHEREIS to only look inside the specified
- ARC files for a matching filename. For example, if you are
- sure that the file named MYPROG.EXE is somewhere on drive C:
- in a .ZIP file, then
-
- whereis c:myprog.exe -zip
-
- would find the file. Specifying individual ARC format switches
- slightly speeds up WHEREIS, because the program doesn't have to
- waste time searching for (and through) all six ARC formats.
-
-
- Switch: "regular expression"
- Meaning: do a grep-type search on the filename
- Description: Any command line string enclosed within double quotes will be
- considered a regular expression, and will cause WHEREIS to go
- into its "grep mode". A regular expression can be used with
- or without a filename search mask.
-
- | As of version 4.1a, when you specify a regular expression,
- | WhereIs will also look inside of 4DOS description files for
- | the string specified. If a match is found, the normal output
- | line will be displayed, along with the actual 4DOS description
- | line below the filename line.
-
- Special characters within the quoted string are as follows:
-
-
- ^ - start matching at the first of the filename
- ? - match any character in this position
- [..] - range check on character at this position
-
- The easiest way to explain is with a few examples:
-
- WhereIs v4.1a Page 6
-
-
- Additional Command Line Switches
-
-
-
- whereis *.bat
-
- the regular search; will display any .BAT file found.
-
-
- whereis *.bat "42"
-
- will display any .BAT file that contains the characters
- "42" anywhere in the filename.
-
-
- whereis *.bat "^???42"
-
- will display any .BAT file that contains the characters
- "42" in the fourth position of the filename.
-
-
- whereis "[0-9]"
-
- will display any file that contains a number anywhere in
- the filename.
-
-
- whereis "[^0-9]"
-
- will display any file that DOES NOT contain a number
- anywhere in the filename.
-
-
- whereis "^???a?[acew-z]"
-
- will display any file that contains an 'a' in the fourth
- position of the filename and the letters 'a', 'c', 'e',
- 'w', 'x', 'y', or 'z' in the sixth position of the name.
-
-
- These grep masks also work when looking inside of ARC files.
-
-
- | Switch: -C"command to execute"
- | -O"command to display"
- | Meaning: Execute (or display) a DOS command on all files found.
- |Description: This switch tells WhereIs to execute the command within the
- | double quotes on each matching file found. When doing this
- | command, you have access to replaceable parameters to get to
- | the full filename, the pathname only, the filename only, and
- | the name of the archive member (if you're searching archives).
- | The only difference between the -o and the -c switches is
- | that -c actually executes the command whereas -o prints the
- | command it WOULD have executed to the screen. Because of
- | this, the -o command can be invaluable. First, you can use
-
- WhereIs v4.1a Page 7
-
-
- Additional Command Line Switches
-
-
- | it before doing the -c command to make sure that what you
- | think you told WhereIs to do is the same as what you DID
- | tell it to do. In other words, if you're about to do a
- | command that could have side effects (such as deleting files),
- | it would be good to do the -o command first and look at what
- | WhereIs actually will do when you execute the -c command.
- | The second use of the -o command is to redirect all of the
- | command lines into a batch file that you can execute later.
- | Replacement parameters for both -c and -o are as follows:
- |
- | Parm Desc Normal example Archive example
- | ---- ---- ----------------- -----------------
- | &f full file name c:\dos\xcopy.exe c:\dos\comlib.zip
- | &p path name only c:\dos\ c:\dos\
- | &n file name only xcopy.exe comlib.zip
- | &m archive member <blank> xcopy.exe
- |
- | A few examples would probably be the best way to explain this
- | concept. Let's do a few "real-world" examples here.
- |
- | 1) You have many .DOC files straying all over your hard drive,
- | and you'd like to incorporate them all into one simple
- | ZIP file. You could do this with the following command:
- |
- | C:> whereis -d *.doc -c"pkzip -m c:\docs.zip &f"
- |
- | 2) You want to make a copy of all of your Pascal source code
- | that has been changed today so that you can take it home
- | with you:
- |
- | C:> whereis -d *.pas -s0 -c"copy &f a:\"
- |
- | 3) You want to get a text file listing of every directory
- | name on your hard drive(s) in the file HARDDRIV.DAT:
- |
- | C:> whereis -d nul -o"&p" >c:\harddriv.dat
- |
- | 4) You want to delete every .BAK file on your system (even
- | those that are in ZIP files). This would be a 2-step
- | process:
- |
- | First, delete the normal .BAK files
- |
- | C:> whereis *.bak -v -n
- |
- | Then, delete them from the archive files
- |
- | C:> whereis -d -ao -zip *.bak -c"pkzip -d &f &m"
- |
-
- Switch: -D
- Meaning: search all available hard drives.
-
- WhereIs v4.1a Page 8
-
-
- Additional Command Line Switches
-
-
- Description: This switch tells WHEREIS to search every hard drive on your
- system (including network drives), starting with C:. In other
- words, if you have drives C:, D:, E:, and F: then the following
- two command lines would do the exact same thing:
-
- whereis cdef:myprog.exe
- or
- whereis myprog.exe -d
-
- Switch: -DUP
- Meaning: Display only duplicate filenames on the drives searched.
- Description: If the -DUP switch is specified, only those files that have
- duplicate entries will be displayed. All other switches are
- active during -DUPlicate processing. For example, the
- following command line:
-
- whereis *.bat -a -d -dup
-
- would cause WhereIs to search all hard drives (-d) looking for
- duplicate .BAT files. WhereIs would also look inside of all
- found Archive files (-a).
-
-
- Switch: -E
- Meaning: use "*.*" for subdirectory searches
- Description: By default, WHEREIS assumes that you don't have any directories
- on your hard drive that have extensions in the filename. So,
- when WHEREIS is looking for new directories, it will search with
- a filemask of "*.". This significantly speeds up the hard drive
- search. If you do have directories that have extensions in their
- names, you must specify the '-e' switch or WHEREIS -will not-
- find files within that subdirectory. The easiest thing to do is
- to set your WHEREIS environment variable to default to this
- option (see "The WHEREIS Environment Variable" below).
-
-
- Switch: -F
- Meaning: display filenames only
- Description: This switch causes WHEREIS to display only the filename of
- matching files that it finds. No header or footer information
- will be displayed. This is most useful when you are
- redirecting the output from WHEREIS to a file.
-
-
- Switch: -G
- Meaning: go to the drive and subdirectory of the found file
- Description: If you specify the '-g' switch, WHEREIS will prompt you with
-
- Goto this subdirectory? _
-
- whenever it finds a matching file. Press 'Y' to change to
- the drive and subdirectory displayed, or 'N' to continue
-
- WhereIs v4.1a Page 9
-
-
- Additional Command Line Switches
-
-
- searching the drive. You may also enter 'Q' to abort WHEREIS.
-
-
- Switch: -H
- Meaning: start searching in the current subdirectory
- Description: The '-h' switch tells WHEREIS "start searching where I'm at
- right now". For example, if you are currently in the TURBOC
- subdirectory, then the following two commands would do the
- exact same thing:
-
- whereis \turboc\myprog.c
- or
- whereis myprog.c -h
-
- With the '-h' switch, WHEREIS can be used as a directory
- program with the ability to list ARC files. For example,
- you could create the following batch file and call it
- ARCDIR.BAT:
-
- @echo off
- whereis %1 -h -a
-
- Now, when you give the command "ARCDIR", you will be shown
- the directory listing, along with all files contained within
- ARC files in your current subdirectory.
-
-
- Switch: -I
- Meaning: ignore the environment variable WHEREIS
- Description: The '-i' switch tells WHEREIS to ignore any default switches
- that you have set with the WHEREIS environment variable. This
- is most useful if you have page-breaking set up as a default,
- but need to redirect WHEREIS's output to a file. You could do
- this with a command such as:
-
- whereis *.bat -i >files.dat
-
-
- Switch: -M -R
- Meaning: modify WHEREIS's default output display
- Description: These switches allow you to modify the way that WHEREIS
- displays its output. By default, WHEREIS will place the
- filename on the left of the screen (just like DIR does).
- If you prefer, you can use '-M' to place the filename in the
- middle of the screen, or '-R' to place the filename on the
- right of the screen. Usually set in the environment.
-
-
- Switch: -K
- Meaning: search only the PATH directories
- Description: This switch will cause WHEREIS to only search in the directories
- that are specified in your DOS PATH environment variable.
-
- WhereIs v4.1a Page 10
-
-
- Additional Command Line Switches
-
-
- This option will be used very rarely, but was requested by a
- user.
- | Note: As of v4.1a, this switch was changed. The '-K' switch was
- | previously the '-C' switch.
-
- Switch: -Y
- Meaning: display the output with European-style dates (DD-MM-YY)
- Description: Again, a seldom-used switch, but requested by a user.
-
-
- Switch: -V [-N]
- Meaning: do a verified delete of any matching files found
- Description: These switches tell WHEREIS to delete any matching files found.
- If you specify only the '-V' switch, then WHEREIS will prompt
- you before it deletes each file. If you specify BOTH the '-V'
- and the '-N' switch, then WHEREIS --WILL NOT-- prompt you; it
- will just go ahead and delete the file (PLEASE be careful with
- this one!). I use these switches daily to clean up all of the
- .BAK files created by Turbo C. For example:
-
- whereis *.bak -v -n
-
-
- Switch: -W
- Meaning: show wasted space occupied by matching files.
- Description: This switch is used very little, but can come in handy if you
- are trying to figure out how much disk space is being wasted
- by a bunch of very small files (batch files are a prime
- example). WHEREIS will total and display to you the amount of
- disk space that is being wasted due to cluster overhead.
-
-
- Switch: -U
- Meaning: display all output in upper case
- Description: Some people still prefer to see directory-type listings in
- ALL UPPER CASE; if you're one of these people, then just use
- the '-U' switch. It's best to set this in your WHEREIS
- environment variable.
-
-
- Switch: -P
- Meaning: pause and wait for a key when the screen fills up
- Description: A very handy switch, best used when set in your environment
- variable. It will cause WHEREIS to pause the screen when it
- fills up, so you don't have to go crazy trying to hit the
- control-S key.
-
-
- Switch: -Xfilemask
- Meaning: exclude this filespec from the search
- Description: The '-X' switch allows you to exclude certain filenames from
- the directory search. You can specify up to 25 exclusion
-
- WhereIs v4.1a Page 11
-
-
- Additional Command Line Switches
-
-
- masks. For example, if you wanted to see all files on your
- drive except for .OBJ and .PRG files, you could do:
-
- whereis *.* -x*.obj -x*.prg
-
-
- Switch: -LT -EQ -GT
- Meaning: specify a file size range
- Description: These switches allow you to only search for files within a
- certain size range. Some examples:
-
- whereis *.PAS -LT1024
-
- would display all .PAS files that have a size smaller than
- 1024 bytes.
-
- whereis *.* -EQ0
-
- would display all files that have a length of zero.
-
- whereis *.* -GT500000
-
- would display all files that are larger than 500,000 bytes.
-
- whereis *.* -GT1023 -LT2049
-
- would display all files that are between 1,024 and 2,048
- bytes in size.
-
-
- Switch: -S -B
- Meaning: specify a file date range
- Description: These switches allow you to only search for files within a
- certain date range. These switches are the "since" (S)
- switch and the "before" (B) switch. Both switches come in
- two flavors; you can specify the date in number of days
- (ie: -S5) or with a full date (ie: -S8-19-89). If you
- specify either switch with no date specifier, then it defaults
- to '0 days'. These date specifiers are also used when looking
- inside of archive files. Some examples:
-
- whereis *.PAS -S5
-
- would display all .PAS files that have a date greater than or
- equal to 5 days ago (in other words, modifed SINCE 5 days ago).
-
- whereis *.PAS -S5-1-89
-
- would display all .PAS files modified SINCE 5/1/89.
-
- whereis *.PAS -B5
-
-
- WhereIs v4.1a Page 12
-
-
- Additional Command Line Switches
-
-
- would display all .PAS files modifed BEFORE 5 days ago.
-
- whereis *.PAS -B5-1-89
-
- would display all .PAS files modified BEFORE 5/1/89.
-
- whereis *.PAS -S5-1-89 -B6-1-89
-
- would display all .PAS files modified between the dates of
- 5-1-89 and 5-31-89.
-
- whereis *.PAS -S
-
- would display all .PAS files that have been modified today
- (defaults to '-S0').
-
-
- Switch: -Z
- Meaning: show only files with their archive bit set
- Description: The '-Z' switch allows you to display only those files which
- have their "archive bit" set on. In other words, it will show
- all files that have been modified since your last backup (if
- your backup program clears the archive bit, that is).
-
-
- Switch: -HIDDEN
- Meaning: also show hidden and system files
- Description: The '-hidden' switch allows you to also display those files
- which are "system" and "hidden" files.
-
- WhereIs v4.1a Page 13
-
-
- The WHEREIS and WI_DRIVES Environment Variables
-
-
-
- When WHEREIS begins execution, it searches the environment for a variable
- named WHEREIS. If this variable is present, its contents will be appended
- onto the command line just as if you had entered them in from the keyboard.
- This option is very handy for setting "default options" that you'd like for
- WHEREIS to perform every time. Simply set the WHEREIS variable in your
- AUTOEXEC.BAT file. For example, if you'd like to always (a) page break
- when the screen fills up, (b) display the filenames on the right of the
- screen, and (c) display output in upper case, you would put the following in
- your AUTOEXEC.BAT file:
-
- SET WHEREIS=-P -R -U
-
-
- WHEREIS would then use these options every time you executed the program.
-
-
- If you specify the "-d" switch (search all drives), then WHEREIS will
- search the environment looking for a variable named WI_DRIVES. If this
- variable is found, WHEREIS will use this list as the definition of the
- drives to search. If the WI_DRIVES variable does not exist, WHEREIS will
- use its own list, which defaults to drives c: through z: (ie: cde...z).
-
- The WI_DRIVES variable was added mainly for those people using networks.
- WHEREIS's reckless abandon of simply searching all drive letters caused
- some network users a lot of headaches. It seems that those affected the
- most were users of Novell networks. On Novell, you can specify many
- different drive letters for the same "volume" (ie: partition), so WHEREIS
- would show the same physical file many times, since WHEREIS thought that
- it was really on a different drive. With the WI_DRIVES variable, it is
- up to the user to tell WHEREIS what drives are physically different. For
- example, let's assume that you have 3 volumes defined, and the drive letter
- assignments are as follows:
-
- Volume 1 - drives C: and D:
- Volume 2 - drives E: and F:
- Volume 3 - drives G: and H:
-
- For WHEREIS to work correctly, you would put the following line in your
- AUTOEXEC.BAT file:
-
- Set WI_DRIVES=CEG
-
- Now, when you search using the "-d" switch, WHEREIS won't list duplicate
- filenames. I have never used a Novell network, so I'm hoping that this
- change will eliminate the problems. This problem was brought up to me in
- a letter from Bud Huddleston of Chamblee, GA. Luckily, he went into great
- detail on what the problem was. The WI_DRIVES variable was the easiest
- way I could think of to attack this problem. If this isn't the best way
- to handle the situation, I'd appreciate it if you Novell users would drop
- me a line with suggestions. Note that the search for the WI_DRIVES variable
- CAN NOT be over-ridden from the command line. If the WI_DRIVES variable
-
- WhereIs v4.1a Page 14
-
-
- The WHEREIS and WI_DRIVES Environment Variables
-
-
- exists, it is used every time. If you need to search a different list,
- you must specify a drive list with the filename instead of using the "-d"
- switch. For example, "whereis cdfg:*.bat".
-
- For those users who are not on a network, you don't need to do anything
- differently from version 3.5 of WHEREIS. If the WI_DRIVES variable isn't
- defined, then v3.6 will perform exactly as v3.5 did.
-
-
- WhereIs v4.1a Page 15
-
-
- Duplicate Filename Searching
-
-
-
- V4.0 of WhereIs incorporates a feature that I've been wanting for a very
- long time - the ability to search all drives, including Archive files, and
- display only those files that are duplicated somewhere else. This was a
- fairly major upgrade to do, but it turned out (in my opinion) to be the best
- added feature to WhereIs yet.
-
- Maybe I'm worse than other people at this, but I'm terrible about doing a
- download of a file, un-Arcing it, and then starting to use it. Of course,
- the original of that file is still sitting out there somewhere in an Archive
- file just eating up hard disk space.
-
- With the new -DUP feature, cleaning up your multiple hard drives from any
- duplicate files is much easier. But, be aware that when you invoke the -DUP
- switch, WhereIs gets VERY memory-hungry. This is because WhereIs must keep
- information on every filename on all of your hard drives (including all of
- those filenames in any Archive files) in memory AT ONE TIME.
-
- If you ever get the message "Error: out of memory!" when trying to find
- duplicates across all drives, there are a couple of things that you can do.
- First of all, see if you can free up any more memory by removing any TSR's
- or device drivers. If you still get the "out of memory" message, then there
- are two different things that you can do. The first is that you could
- compare the drives two (or three) at a time. For example, if you
- have drives C:, D:, E:, and F:, first compare drives C: and D:, then C: and
- E:, etc. until you've scanned them all.
-
- The second thing you can do (the way I prefer) is to do the duplicate scan
- with a filemask; in other words, do the scan on *.EXE, then *.COM, then
- *.BAT, etc. For example, here's a sample of what you'd do:
-
- C:> whereis *.com -d -a
-
- C:> whereis *.bat -d -a
-
- C:> whereis *.exe -d -a
-
- I don't see the "out of memory" being a problem except for those people
- with HUGE hard drives. I have two 40-meg drives, both packed full of ZIP
- files, and I never got close to filling up memory. In addition, WhereIs
- is fairly intelligent when saving the names in memory; for example, if
- you have 300 files in the path C:\TEST1\TEMP\DATA, the actual pathname
- will only get saved one time. If you are looking for duplicates on a very
- big hard drive system (let's say 80 meg or more), then WhereIs will take some
- time. Don't be alarmed if the program seems to not be doing anything;
- searching the file tables of very large hard drives takes some time. I
- tinkered with the idea of putting in a twirling cursor or something so that
- you'd know WhereIs was still alive, but I decided against it. Since
- duplicate searching will probably be redirected to a printer or a disk file
- most of the time, I didn't want to trash up the display.
-
-
-
- WhereIs v4.1a Page 16
-
-
- Duplicate Filename Searching
-
-
- Don't forget that the -DUP switch works in tandem with ALL other WhereIs
- switches. For example, specifying -DUP doesn't automatically scan all hard
- drives and look inside all Archive files. You must still specify the -A and
- -D switches. Also, filename exclusions still work just like normal.
- Let's do a few examples:
-
-
- C:> whereis -d -a -dup
-
- This is the command you'll normally want to do when
- searching for duplicates. It causes WhereIs to search
- all hard drives, and inside Archive files, looking for
- duplicates.
-
-
- C:> whereis *.bat -d -a -dup
-
- This command would only list the duplicate .BAT files
- on your hard drives.
-
- C:> whereis cd:*.* -a -dup -x*.bak -x*.doc
-
- This command would display all duplicate files on drives
- C: and D: except any .BAK or .DOC files.
-
-
- WhereIs v4.1a Page 17
-
-
- Change History
-
-
-
- v1.0 o Initial release.
-
- v1.1-1.7 o Internal testing changes.
-
- v1.8 o Added the ability to specify multiple drives and filespecs
- on the command line (ie: whereis cde:*.dat d:test.prg).
- o Added the '-D' switch to search all drives.
- o Added the '-E' switch to allow "*.*" use for directory
- searches.
- o Added the '-G' switch for "goto found subdirectory".
- o Added the '-P' switch for page breaking.
- o Added the '-V' switch for file deletion.
- o Added support for the WHEREIS environment variable.
- o Added the '-I' switch to ignore the environment variable.
-
- v1.9 o Filenames are now searched for first in the current
- directory instead of searching for subdirectories first.
-
- v2.0 o Changed to the three different display formats.
- o Enhanced Control-C checking to allow aborting at any time.
- This was not the case in prior versions if a user didn't
- have BREAK=ON specified in their AUTOEXEC.BAT file.
- o Changed the '-G' switch to prompt the user before going
- to the found subdirectory.
-
- v2.1-2.3 o Internal testing changes.
-
- v2.4 o Added the "European-style" date display, per a user's
- request.
- o Added the '-W' switch to show wasted space.
- o Added the '-H' switch to display filenames only.
- o Added ZIP file searching.
-
- v2.5-2.6 o Internal testing changes.
-
- v2.7 o Added LHARC file searching.
-
- v2.8 o Added ZOO file searching.
-
- v2.9 o Internal testing changes.
-
- v3.0 o Changed the default display mode to put the filename on
- the left of the screen.
- o Added the ability to search specific ARC file formats.
- o Added the '-AO' switch to search only archives.
- o Added the '-F' to display filenames only.
- o Changed the '-H' switch to start the search in the
- current directory.
- o Added the ability to exclude filenames with the
- '-X' switch (up to 25 supported).
- o Added the '-LT', '-EQ', and '-GT' switches for size
-
- WhereIs v4.1a Page 18
-
-
- Change History
-
-
- range searching.
- o Added the '-S' and '-B' switches for date range
- searching.
- o Added the '-C' switch for searching only the PATH
- directories.
- o Changed the '-W' switch to get the true cluster size
- for each drive searched. Earlier versions simply
- assumed a cluster size of 2048 bytes.
-
- v3.1 o Fixed an obscure bug that would sometimes cause the
- 'date range' search to display files out of the range
- if a file happenned to fall on the last day of any month
- that had 31 days in it. All date range checks are now
- done with Greenwich Mean Time for added accuracy.
-
- v3.2-3.3 o Internal testing changes.
-
- v3.4 o Added grep-type searching on filenames.
- o Added a '-U' switch to display all output in upper
- case.
- o Changed so that if you don't specify at least one
- filespec on the command line, the default will be "*.*".
- For example, in earlier versions you would have to say
- "whereis *.* -s". Now you can just say "whereis -s".
-
- v3.5 o Sped up ZIP searching by 50% due to a new method of
- locating the "central directory".
- o Sped up "grep" searching through archives by almost 70%.
- o Added a '-z' switch, which only displays files that have
- their "archive bit" set (ie: displays files modified
- since your last backup was made).
-
- v3.6 o Added the "-hidden" switch which informs WHEREIS to
- include system and hidden files in the search.
- o Added the optional WI_DRIVES environment variable to
- hopefully alleviate some of the problems that occur
- when WHEREIS is used on a Novell network.
-
- v3.7 o Sped up the grep searching slightly.
- o ZIP searching now does a much better job of looking
- for "corrupted" ZIP files.
-
- v3.8 o These version numbers were skipped.
- v3.9
-
- v4.0 o Added the ability to display only duplicate filename
- entries.
- o v4.0 marks the beginning of Shareware marketing.
- o The program will no longer pause with the "More"
- message if WhereIs detects that the output is being
- redirected to a file or a printer.
-
-
- WhereIs v4.1a Page 19
-
-
- Change History
-
-
- v4.1a o Added the ability to execute a DOS command on any file
- matches found.
-
- o When you specify a "grep mask", WhereIs will now also
- search inside of 4DOS's description files.
-
- End of document.
-